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FOREWORD 


This  technical  report  covers  work  performed  under  Air  Force 
Contract  F33600-87-C-0464,  DAPro  Project.  This  contract  is 
sponsored  by  the  Manufacturing  Technology  Directorate,  Air  Force 
Systems  Command,  Wright-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Bruce  A. 
Rasmussen,  Branch  Chief,  Integration  Technology  Division, 
Manufacturing  Technology  Directorate,  through  Mr.  David  L.  Judson, 
Project  Manager.  The  Prime  Contractor  was  Integration  Technology 
Services,  Software  Programs  Division,  of  the  Control  Data 
Corporation,  Dayton,  Ohio,  under  the  direction  of  Mr.  W.  A. 
Osborne.  The  DAPro  Project  Manager  for  Control  Data  Corporation 
was  Mr.  Jimmy  P.  Maxwell. 

The  DAPro  project  was  created  to  continue  the  development,  test, 
and  demonstration  of  the  Integrated  Information  Support  System 
(IISS) .  The  IISS  technology  work  comprises  enhancements  to  IISS 
software  and  the  establishment  and  operation  of  IISS  test  bed 
hardware  and  communications  for  developers  and  users. 

The  following  list  names  the  Control  Data  Corporation 
subcontractors  and  their  contributing  activities: 


SUBCONTRACTOR 


ROLE 


Control  Data  Corporation 


D .  Appleton  Company 


ONTEK 


Responsible  for  the  overall  Common 
Data  Model  design  development  and 
implementation,  IISS  integration  and 
test,  and  technology  transfer  of  IISS. 

Responsible  for  providing  software 
information  services  for  the  Common 
Data  Model  and  IDEFlX  integration 
methodology. 

Responsible  for  defining  and  testing  a 
representative  integrated  system  base 
in  Artificial  Intelligence  techniques 
to  establish  fitness  for  use. 


Simpact  Corporation 


Structural  Dynamics 
Research  Corporation 


Arizona  State  University 


Responsible  for  Communication 
development . 

Responsible  for  User  Interfaces, 
Virtual  Terminal  Interface, and  Network 
Transaction  Manager  design, 
development,  implementation,  and 
support . 

Responsible  for  test  bed  operations 
and  support . 
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SECTION  1 
GENERAL 


1. 1  Purpose 

This  unit  test  plan  establishes  the  methodology  and 
procedures  used  to  adet^ately  test  the  capabilities  of  the 
computer  program  identified  as  the  Form  Processor,  known  in 
this  document  as  the  FP.  The  FP  is  one  configuration  item  of 
the  Integrated  Information  Support  System  (IISS)  User  Interface 
(UI) .  It  consists  of  Form  Processor  callable  routines  and  the 
User  Interface  Monitor  which  is  the  main  controller  of  the  Form 
Processor. 

1 . 2  Project  References 

[1]  Systran  ICAM  Document at ion  Standards ,  15  September 
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[3]  Structural  Dynamics  Research  Corporation,  Form 
Processor  Development  Specification,  DS  620344200, 

31  May  1988. 

[4]  Structural  Dynamics  Research  Corporation,  Forms 
Language  Compiler  Unit  Test  Plan,  UTP620344401, 
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Unit  Test  Plan,  UTP620344600,  31  May  1988. 
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1 . 3  Terms  and  Abbreviations 

American  Standard  Code  for  Information  Interchange: 

(ASCII),  the  character  set  defined  by  ANSI  X3.4  and  used  by  most 
computer  vendors. 

Application  Interface:  (AI) ,  subset  of  the  IISS  User 
Interface  that  consists  of  the  callable  routines  that  are  linked 
with  applications  that  use  the  Form  Processor  or  Virtual 
Terminal.  The  AI  enables  applications  to  be  hosted  on  computers 
other  than  the  host  of  the  User  Interface. 

Application  Process:  (AP) ,  a  cohesive  unit  of  software  that 
can  be  initiated  as  a  unit  to  perform  some  function  or 
functions. 

Attribute;  field  characteristic  such  as  blinking, 
highlighted,  black,  etc.  and  various  other  combinations. 
Background  attributes  are  defined  for  forms  or  windows  only. 
Foreground  attributes  are  defined  for  items.  Attributes  may  be 
permanent,  i.e.,  they  remain  the  same  unless  changed  by  the 
application  program,  or  they  may  be  temporary,  i.e.,  they  remain 
in  effect  until  the  window  is  redisplayed. 

Common  Data  Model ;  (CDM) ,  IISS  subsystem  that  describes 
common  data  application  process  formats,  form  definitions,  etc. 
of  the  IISS  and  includes  conceptual  schema,  external  schemas, 
internal  schemas,  and  schema  transformation  operators. 

Computer  Program  Configuration  Item;  (CPCI) ,  an  aggregation 
of  computer  programs  or  any  of  their  discrete  portions,  which 
satisfies  an  end-use  function. 

Conceptual  Schema;  (CS) ,  the  standard  definition  used  for 
all  data  in  the  CDM.  It  is  based  on  IDEFl  information 
modelling. 

Current  Cursor  Position;  the  position  of  the  cursor  before 
an  edit  command  or  function  is  issued  in  the  text  editor. 

Cursor  Position;  the  position  of  the  cursor  after  any 
command  is  issued. 

Device  Drivers ;  (DD) ,  software  modules  written  to  handle 
I/O  for  a  specific  kind  of  terminal.  The  modules  map  terminal 
specific  commands  and  data  to  a  neutral  format.  Device  Drivers 
are  part  of  the  UI  Virtual  Terminal. 

Display  List;  a  list  of  all  the  open  forms  that  are 
currently  being  processed  by  the  FP  or  the  user. 

Display  size;  the  number  of  lines  used  in  the  edit  area. 

Extended  Binary  Coded  Decimal  Interchange  Code;  (EBCDIC) , 
the  character  set  used  by  a  few  computer  vendors  (notably  IBM) 
instead  of  ASCII. 
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External  Schema ;  (ES) ,  an  application's  view  of  the  CDM's 
conceptual  schema . 

Field;  two  dimensional  space  on  a  terminal  screen. 

Field  Pointer:  indicates  the  ITEM  which  contains  the 
current  cursor  position. 

Form:  structured  view  which  may  be  imposed  on  windows  or 
other  forms .  A  form  is  composed  of  fields.  These  fields  may  be 
defined  as  forms,  items,  and  windows. 

Form  Definition;  (FD) ,  forms  definition  language  after 
compilation.  It  is  read  at  runtime  by  the  Form  Processor. 

Forms  Definition  Language :  (FDL) ,  the  language  in  which 
electronic  forms  are defined. 

Forms  Driven  Form  Editor:  (FDFE) ,  subset  of  the  FE  which 
consists  of  a  forms  driven  application  used  to  create  Form 
Definition  files  interactively. 

Form  Editor;  (FE) ,  subset  of  the  IISS  User  Interface  that 
is  used  to  create  definitions  of  forms.  The  FE  consists  of  the 
Forms  Driven  Form  Editor  and  the  Forms  Language  Compiler. 

Form  Hierarchy;  a  graphic  representation  of  the  way  in 
which  forms^I  items  and  windows  are  related  to  their  parent  form. 

Forms  Language  Compiler;  (FLAN) ,  subset  of  the  FE  that 
consists  of  a  batch  process  that  accepts  a  series  of  forms 
definition  language  statements  and  produces  form  definition 
files  as  output. 

Form  Processor;  (FP) ,  subset  of  the  IISS  User  Interface 
that  consists  of  a  set  of  callable  execution  time  routines 
available  to  an  application  program  for  form  processing. 

Form  Processor  Text  Editor;  (FPTE) ,  subset  of  the  Form 
Processor  that  consists  of  software  modules  that  provide  text 
editing  capabilities  to  all  users  of  applications  that  use  the 
Form  Processor. 

Integrated  Info^ation  Support  System;  (IISS) ,  a  computing 
environment  used  to  investigate,  demonstrate,  test  the  concepts 
and  produce  application  for  information  management  and 
information  integration  in  the  context  of  Aerospace 
Manufacturing.  The  IISS  addresses  the  problems  of  integration 
of  data  resident  on  heterogeneous  data  bases  supported  by 
heterogeneous  computers  interconnected  via  a  Local  Area  Network. 

Item;  non-decomposable  area  of  a  form  in  which  hard-coded 
descriptive  text  may  be  placed  and  the  only  defined  areas  where 
user  data  may  be  input/output. 
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Lo<yical  Device;  a  conceptual  device  that  identifies  a  top 
level  window  of  an  application.  It  is  used  to  distinguish 
between  multiple  applications  running  simultaneously  on  a 
physical  device.  NOTE;  a  single  application  can  have  more  than 
one  logical  device.  To  the  end  user  this  also  appears  as 
multiple  applications  running  simultaneously. 

Message;  descriptive  text  which  may  be  returned  in  the 
standard  message  line  on  the  terminal  screen.  They  are  used  to 
warn  of  errors  or  provide  other  user  information. 

Message  Line;  a  line  on  the  terminal  screen  that  is  used  to 
display  messages. 

Network  Transaction  Manager;  (NTM) ,  IISS  subsystem  that 
performs  the  coordination,  communication  and  housekeeping 
functions  required  to  integrate  the  Application  Processes  and 
System  Services  resident  on  the  various  hosts  into  a  cohesive 
system. 

Open  List;  a  list  of  all  the  forms  that  are  currently  open 
for  an  application  process. 

Operating  System;  (OS) ,  software  supplied  with  a  computer 
which  allows  it  to  supervise  its  own  operations  and  manage 
access  to  hardware  facilities  such  as  memory  and  peripherals. 

Page;  instance  of  forms  in  windows  that  are  created 
whenever  a  form  is  added  to  a  window. 

Paging  and  Scrolling;  a  method  which  allows  a  form  to 
contain  more  data  than  can  be  displayed  with  provisions  for 
viewing  any  portion  of  the  data  buffer. 

Physical  Device;  a  hardware  terminal. 

Presentation  Schema ;  (PS) ,  may  be  equivalent  to  a  form.  It 
is  the  view  presented  to  the  user  of  the  application. 

Previous  Cursor  Position;  the  position  of  the  cursor  when 
the  previous  edit  command  was  issued. 

Qualified  Name;  the  name  of  a  form,  item  or  window  preceded 
by  the  hierarchy  path  so  that  it  is  uniquely  identified. 

Report  Definition  Language ;  an  extension  of  the  Forms 
Definition  Language  that  includes  retrieval  and  calculation  of 
database  information  and  is  used  to  define  reports. 

Subform;  a  form  that  is  used  within  another  form. 

User  Data;  data  which  is  either  input  by  the  user  or 
output  by  the  application  programs  to  items. 

User  Interface;  (UI) ,  IISS  subsystem  that  controls  the 
user's  terminal  and  interfaces  with  the  rest  of  the  system.  The 
UI  consists  of  two  major  subsystems;  the  User  Interface 
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Development  System  (UIDS)  and  the  User  Interface  Management 
System  (UIMS) . 

User  Interface  Development  System;  (UIDS) ,  collection  of 
IISS  User  Interface  subsystems  that  are  used  by  applications 
programmers  as  they  develop  IISS  applications.  The  UIDS 
includes  the  Form  Editor  and  the  Application  Generator. 

User  Interface  Management  System;  (UIMS),  the  runtime  UI. 

It  consists  of  the  Form  Processor,  Virtual  Terminal,  Application 
Interface,  the  User  Interface  Services  and  the  Text  Editor. 

User  Interface  Monitor;  (UIM) ,  part  of  the  Form  Processor 
that  handles  messaging  between  the  NTM  and  the  UI.  It  also 
provides  authorization  checks  and  initiates  applications. 

User  Interface/Virtual  Terminal  Interface;  (UI/VTI) , 
another  name  for  the  User  Interface. 

Virtual  Terminal ;  (VT) ,  subset  of  the  IISS  User  Interface 
that  performs  the  interfacing  between  different  terminals  and 
the  UI.  This  is  done  by  defining  a  specific  set  of  terminal 
features  and  protocols  which  must  be  supported  by  the  UI 
software  which  constitutes  the  virtual  terminal  definition. 
Specific  terminals  are  then  mapped  against  the  virtual  terminal 
software  by  specific  software  modules  written  for  each  type  of 
real  terminal  supported. 

Virtual  Terminal  Interface;  (VTI) ,  the  callable  interface 
to  the  VT. 

Window;  dynamic  area  of  a  terminal  screen  on  which 
predefined  forms  may  be  placed  at  run  time. 

Window  Manager ;  a  facility  which  allows  the  following  to  be 
manipulated;  size  and  location  of  windows,  the  device  on  which 
an  application  is  running,  the  position  of  a  form  within  a 
window.  It  is  part  of  the  Form  Processor. 
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SECTION  2 

DEVELOPMENT  ACTIVITY 


2 . 1  Statement  of  Pretest  Activity 

During  system  development,  the  computer  programs  were 
tested  progressively.  Functionality  was  incrementally  tested, 
and  as  bugs  were  discovered  by  this  testing,  the  software  was 
corrected. 

Each  Form  Processor  callable  routine  was  tested 
individually  through  Form  Processor  development.  A  test 
program,  ARTEST,  was  developed  as  an  easy  means  of  testing 
changes  to  the  Form  Processor.  This  test  program  allows  a 
developer  to  type  in  commands  that  are  translated  into  the 
appropriate  Form  Processor  calls.  With  this  test  program  all 
Form  Processor  callable  routines  may  be  executed. 

Testing  of  the  User  Interface  Monitor  (UIM)  of  the  Form 
Processor  began  with  the  integration  of  the  Form  Processor  and 
the  NTM.  The  UIM's  main  task  is  to  receive  messages  sent  to  the 
Form  Processor.  A  test  minintm  was  developed  also  so  that  the 
Window  Management  processing  capability  of  the  Form  Processor 
could  be  tested  before  integration  with  the  NTM. 

All  pretesting  activity  was  conducted  by  the  individual 
program  developer  in  a  manual  mode.  The  developer  would 
manually  enter  data  onto  the  screen  and  observe  the  results. 

Any  errors  were  noted  by  the  developer,  and  corrections  to  the 
Form  Processor  software  were  then  made  after  a  testing  session. 

2 . 2  Pretest  Activity  Results 

The  pretest  activity  was  very  successful  in  the  elimination 
of  programming  bugs  so  that  at  release  time  only  a  few  bugs  were 
found  in  the  Form  Processor.  The  development  of  the  test 
program,  ARTEST,  has  proved  very  beneficial  since  as  new 
functionality  was  added  to  the  Form  Processor,  ARTEST  was  also 
updated  to  test  this  functionality.  ARTEST  is  the  major  test 
tool  for  the  Unit  Test  Plan  of  the  Form  Processor. 

The  minintm  was  useful  in  testing  the  window  management 
processing;  however,  it  postponed  our  integration  with  the  real 
NTM  since  it  was  easier  to  run  and  test  standalone.  This 
integration  was  a  difficult  process.  The  only  significant  bug 
found  in  the  window  management  processing  through  the  NTM 
integration  was  incorrect  use  of  the  Source  as  the  application 
name  in  an  Application  End  message. 

The  pretesting  activity  was  successful  in  eliminating 
programming  errors  and  helped  pinpoint  difficulties  in 
integration  with  the  NTM. 
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SECTION  3 

SYSTEM  DESCRIPTION 


3 . 1  System  Description 

The  Form  Processor  consists  of  a  set  of  callable  execution 
time  routines  that  allows  an  application  program  to  send/receive 
formatted  screens  to/from  various  terminals  and  to  perform 
terminal  control  functions  independent  of  the  terminal  type.  It 
also  has  a  User  Interface  Monitor  (UIM)  that  handles  translating 
messages  sent  across  the  NTM  into  the  appropriate  FP  calls.  The 
UIM  also  handles  the  log  on  to  IISS,  processing  the  IISS 
Function  Screen  and  processing  the  application  status  form. 

3 . 2  Testing  Schedule 

The  execution  of  the  Form  Processor  is  dependent  upon  the 
NTM  subsystem  of  IISS  when  it  is  not  configured  standalone. 
Testing  of  the  Form  Processor  must  be  done  only  after  the  NTM 
has  been  successfully  tested.  In  this  unit  test,  the  Form 
Processor  is  dependent  on  the  Application  Interface  (AI)  and  on 
the  Virtual  Terminal  (VT) . 

3 . 3  First  Location  Testing 

These  tests  of  the  Form  Processor  require  the  following; 

E(^ipment:  Air  Force  VAX,  terminals  supported  by  the 
Virtual  Terminal  as  listed  in  the  UI  Terminal  Operator 
Guide. 

Support  Software:  Release  2.0  of  the  Integrated  Information 
Support  System, the  Relational  Software  Incorporated 
Oracle  database  management  system. 

Personnel:  One  integrator  familiar  with  the  IISS. 

Training;  The  FP  User  Manual  has  been  previously 
provided  with  the  current  release. 

Deliverables;  The  current  release  of  the  User  Interface 
Management  Subsystem. 

Test  Materials:  This  test  may  be  run  interactively  by 
inputting  the  appropriate  data  and  observing  the  output  as 
outlined  in  this  test  plan.  A  script  file  has  also  been 
created  and  run  generating  a  save  file  to  be  used  for 
comparison  in  subsequent  tests  of  this  subsystem. 

Security  considerations:  None. 

3 . 4  Subsequent  Location  Testing 

The  requirements  as  listed  above  need  to  be  met;  however, 
in  subsequent  testing  it  is  advantageous  to  create  a  script  file 
of  the  outlined  tests  and  run  this  saving  the  output  of  the  test 
for  future  comparisons. 
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SECTION  4 

SPECIFICATIONS  AND  EVALUATIONS 


4 . 1  Test  Specifications 


The  test  uses  the  program  ARTEST  to  test  the  following 
areas  of  functionality  as  specified  in  section  3.2  of  the  Form 
Processor  Development  Specification: 

o  Form  processing 
o  User  Profile  Maintenance 
o  Virtual  Terminal  Pass-through 
o  NTM  message  processing 
o  Function  key  processing 

The  following  sections  list  the  FP  routines  that  handle  the 
particular  area  of  functionality,  where  appropriate.  The 
associated  figures  refer  to  the  specific  activities  performed  in 
section  5.3  to  test  each  area. 


4.1.1  Form  Processing 

Controlling  the  Form  Processor: 

INITFP  -  Figures  2a, b 
TERMFP  -  Figures  58a, b 
SETDQN  -  Figures  32a,  32d-f 
GETDQN  -  Figures  32b, c 

Opening  and  Closing  Forms: 

OPNFRM  -  Figures  8a-d 
CLSFRM  -  Figures  15a-c 

Creating  and  Saving  Forms: 

CRTFRM  -  Figures  104a,  104c 
SAVFRM  -  Figures  151a-c 
REPFRM  -  Figures  103a,b 
MAKFRM  -  Figures  105a, b 


Adding  and  Removing  Fields: 


CRTFLD  -  Figures 
ADDFLD  -  Figures 
REPFLD  -  Figures 
MVRFLD  -  Figures 
RMVFLD  -  Figures 
GFMFLD  -  Figures 
GDPFEX  -  Figures 
GDPFLC  -  Figures 


99a, b 
97a-98b, 
100a, c 
101a,b 
102 

109a-e 

107a-c 

108 


99c,  104b, c 
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Changing  Characteristics: 


ADDOIM  -  Figures 
INQSIZ  -  Figures 
INQDOM  -  Figures 
INQLOC  -  Figures 
INQTYP  -  Figures 
INQAPR  -  Figures 
RMVATT  -  Figures 
RMVDOM  -  Figures 
RMVHLP  -  Figures 
RMWAL  -  Figures 
SETAPR  -  Figures 
SETDIM  -  Figures 
SETDIS  -  Figures 
SETLOC  -  Figures 

SETVAL  -  Figures 
SETS I Z  -  Figures 

SETHLP  -  Figures 


Modifying  the  Display 

ADDEIH  -  Figures 
ADDFRM  -  Figures 
APRFLD  -  Figures 
GETATT  -  Figures 
GETBAK  -  Figures 
GPAGE  -  Figures 
GWINDO  -  Figures 
PUTATT  -  Figures 
PUTBAK  -  Figures 
RMVPAG  -  Figures 
RPLFRM  -  Figures 

Transferring  Data: 

PDATA  -  Figures 
GDATA  -  Figures 

Displaying  Forms: 

OUTSCR  -  Figures 
OISCR  -  Figures 

Getting  and  Setting  t 


110a, b 

INQATT 

139a-c 

INQDIM 

132 

INQVAL 

134a, b 

INQABS 

140a-c 

INQPRO 

155,158,159 

INQHLP 

142a-d 

RMVDIM 

145a, b 

147a, b 

RMVARY 

150a-d 

RMVPRO 

156,157 

RMVAPR 

120a, b 

SETDOM 

99c, d 

100b, c. 

SETNAM 

118a-d 

SETTYP 

126a-128b 

122a-d, 

124a-d 

SETATT 

117a-f 

SETPRO 

List: 

7a-v 

8a-d 

153a-d 

22a, b 

6a, b 

11a, b 

12a, b 

23a, 24b, 27a- 

•C 

25a, b, 28a, b 

10a, b 

9a, b 

16a, b,  18a, b 
17a, b,  19a, b 


31a-c 

31a-c 

e  Cursor  Position: 


GETCUR  -  Figures  29a, b 
PARFQN  -  Figures  30a,b 
PUTCUR  -  Figures  29a-c 

Displaying  Messages: 

PMSGLC  -  Figures  34k 
PMSGLS  -  Figures  34n 


Figures 

Figures 

Figures 

Figures 

Figures 

Figures 

Figures 

Figures 

Figures 

Figures 

Figures 

Figures 

Figures 


Figures 

Figures 


130a-c 
138a, b 
141 

129a-c 
136a-c 
133a-c 
112a, b 
144a ,  b 
148a, b 
137a, b 
160-163 
llla-e, 
113a-d 
110a, b 
121a-c, 
123a, b 
125a-d 
115a, b 
114a-f , 
135c-e 
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Creating  and  Modifying  Logical  Devices; 

CHGLDV  -  Figures  40a, b 
CLSLDV  -  Figures  54a, b 
GETLDV  -  Figures  36a, b 
INQLDV  -  Figures  35a,b 
MOVLDV  -  Figures  52a-c 
OPNLDV  -  Figures  39a, b 
SETLDV  -  Figures  37a, b  38a, b 

4.1.2  User  Profile  Maintenance 


GTUINF  -  Figures  3a, b 

4.1.3  virtual  Terminal  Pass-through 

GETVTI  -  Figures  4a, b 
INITVT  -  Figures  4a-6b 
PUTVTI  -  Figures  6a, b 
TERMVT  -  Figures  4a-6b 

4.1.4  NTM  Message  Processing 
All  Figures 

4.1.5  Function  Key  Processing 


Control  Keys;  All  Figures 

Application  Mode  Keys;  Figures  29b, c 

Scroll/Page  Mode  Keys;  Figures  34a-o 

Text  Editor  Mode  Keys;  Figures  60a-94 

Window  Manager  Mode  Keys;  Figures  41a-53d 

Status  Mode  Keys;  50b, c,  51a, b,  52c,  53a,  56d,e,  57a, b, 

58a 

4 . 2  Testing  Methods  and  Constraints 

The  tests  as  outlined  in  Section  5  must  be  followed.  The 
required  input  is  stated  for  each  test.  This  testing  uses  the 
normal  mode  of  operation  of  these  functions  and  does  not 
completely  exercise  all  the  error  combinations  that  a  user  of 
the  Form  Processor  might  create  by  faulty  entry  of  form  field 
information.  Much  of  this  testing  has  been  done,  however, 
through  the  normal  testing  done  by  the  developer  of  these 
functions.  No  data  recording  is  required.  It  is  suggested  that 
on  further  running  of  this  test,  scripting  of  the  test  may  be 
done  and  the  output  from  running  the  script  be  saved  for  future 
testing.  No  additional  constraints  are  placed  on  this  unit  test 
besides  those  listed  in  Section  3.3  of  this  unit  test  plan. 
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4 . 3  Test  Progression 

The  progression  of  testing  of  the  Form  Processor  is  fully 
outlined  in  Section  5  of  this  unit  test  plan.  This  progression 
should  be  followed  exactly  to  insure  the  successful  testing  of 
this  IISS  configuration  item. 

4 . 4  Test  Evaluation 


The  test  results  are  evaluated  by  comparing  the  information 
returned  on  the  various  output  screens  to  that  specified  as 
successful  for  the  given  test.  As  outlined  in  Section  5,  each 
test  of  Form  Processor  functionality  provides  an  input  screen 
with  the  required  data  entry  specified  and  the  resulting  output 
for  a  successful  test.  To  speed  up  this  testing  and  provide 
more  accurate  measurement  of  the  test's  success,  scripting  has 
been  used.  The  resulting  output  of  this  test  is  saved  in  the 
files  FPUTP.SAV,  FPTEUTP.SAV,  and  FPDFUTP.SAV.  The 
corresponding  test  script  files  are  FPUTP.SCP,  FPTEUTP.SCP,  and 
FPDFUTP.SCP.  All  of  these  files  are  under  IISS  Configuration 
Management.  If  scripting  is  used,  these  files  should  be  copied 
over  to  the  test  directory.  The  .SAV  file  may  be  used  for 
future  comparison  against  the  corresponding  ...TST.SAV  files 
generated  when  running  this  unit  test  using  scripting.  To 
compare  the  results  use  the  command  file  DIFFILE.COM  which  is 
under  configuration  management.  The  only  differences  should  be 
the  date/time  stamps  on  the  IISS  Function  Screen  and  the  type  of 
device  on  the  window  manager  screen.  The  device  type  is  given 
to  the  UIS  by  the  NTM  at  run  time. 
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SECTION  5 
TEST  PROCEDURES 


5. 1  Test  Description 

The  program  ARTEST  is  used  to  perform  this  test.  Commands 
are  entered  on  the  ARTEST  form  Command  Line  field.  The  commands 
are  then  translated  by  the  program  into  a  call  to  the 
appropriate  Form  Processor  routine,  and  the  resulting  output  is 
observed  on  the  ARTEST  form. 

The  following  keys  are  used  to  move  within  forms  (using  the 
VTIOO  terminal  as  an  example) :  the  <ENTER>  key  is  used  to 
activate  all  commands;  the  <TAB>  key  is  used  to  move  from  field 
to  field  within  the  form;  and  the  arrow  keys  are  used  to  move 
within  fields.  In  addition,  ESC  TAB  is  a  reverse  TAB.  The 
keypad  layouts  for  the  various  modes  are  shown  in  Appendix  B. 

5 . 2  Test  Control 


As  outlined,  this  unit  test  may  be  done  manually  or  run 
automatically  using  the  supplied  script  files.  To  manually 
perform  this  unit  test  the  tester  must  be  logged  into  the  IISS 
system  and  enter  ARTEST  on  the  llSS  Function  Screen.  In  section 

5.3  the  required  input  data  is  specified  for  each  function  being 
tested  and  the  resulting  successful  output  is  also  specified. 

The  order  of  the  testing  is  also  completely  specified.  The  test 
control  information  is  completely  described  by  the  sequence  of 
the  input  and  output  sreens  presented  in  this  section.  The 
success  of  the  test  may  be  determined  by  doing  a  comparison  on 
the  .SAV  files  produced  against  the  ones  provided  under  IISS 
Configuration  Management. 

5 . 3  Test  Procedures 

To  run  the  unit  test  plan  as  outlined  in  this  section  on  a 
VAX,  one  must  be  logged  on  to  an  IISS  account.  The  NTM  must  be 
up  and  running  and  the  UI  group  logical  names  IISSFLIB  and 
IISSMLIB  must  be  set  properly.  IISSFLIB  points  to  the  directory 
containing  production  form  definitions  (FD  files) .  IISSMLIB 
points  to  the  directory  containing  error  messages  (MSG  files) . 

This  unit  test  uses  the  program  ARTEST  and  its  associated 
forms  ffl  through  ff39.  The  FDL  source  file  for  these  forms  is 
presented  in  Appendix  A.  The  executable  for  ARTEST  should  exist 
in  the  NTM  environment  directory  and  the  NTM  dirtbl.dat  should 
have  its  SD  entry  pointing  to  this  directory.  The  NTM  tables 
APITBL  and  APTTBL  should  have  ARTEST  set  up  as  a  normal  IISS 
application  program.  This  test  also  uses  the  files  PRINT. DEV 
and  FPUTP.DAT.  They  must  be  created  in  the  NTM  environment 
directory  before  beginning  the  test. 
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Assuming  the  NTM  is  up  and  running,  an  IISS  user  may  start 
this  unit  test  plan  as  follows: 

$  SET  DEF  <to  directory  containing  your  NTM  environment> 

$  VTIOO  -RFPUTP.SCP  -SFPTST.SAV 

This  starts  up  the  VTIOO  device  driver  with  the  first  of 
three  source  scripts  as  input  and  specifies  a  save  file  for 
output.  If  the  User  Interface  system  has  been  installed  at  your 
site  with  a  different  device  driver,  then  this  step  is  amended 
as  appropriate.  The  test  begins  executing  on  the  terminal. 

When  the  $  returns,  run  the  second  script  by  entering: 

$  VTIOO  -RFPTEUTP.SCP  -SFPTETST. SAV 
When  the  $  returns  again,  run  the  thris  script  by  entering: 

$  VTIOO  -RFPDFUTP.SCP  -SFPDFTST. SAV 

The  results  of  the  test  are  saved  in  the  .SAV  files.  These 
files  should  be  compared  with  the  appropriate  .SAV  files  under 
Configuration  Management  as  described  in  Section  4.4.  The 
following  figures  show  not  only  the  form  input  and  output  but 
also  the  sequencing  of  the  test. 


Figure  5-la  Logon  Screen 
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Figure  5-lb  Enter  User  Information 
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Figure  5-lc  IISS  Function  Screen 
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Figure  5-2a  Start  ARTEST  Application 
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Figure  5-2b  First  ARTEST  Screen 
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Figure  5-3a  Test  GTUINF 
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Figure  5-3b  GTUINF  Result 
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Figure  5-4a  Test  GETVTI 
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Figure  5-4b  GETVTI  Result 
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Enter 


Figure  5-5a  Enter  Data  for  GETVTI 


”xx"  in  form  ff2  as  shown  and  press  <ENTER>. 
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Figure  5-5b  GETVTI  Result 
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Figure  5-6a  Test  PUTVTI 
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Figure  5-6b  PUTVTI  Result 
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Figure  5-7a  Add  Fixed  Size  Form 
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Figure  5-7b  After  Adding  Fixed  Size  Form 
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5-7d  Form  fflO 


with  One  Element 
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Figure  5-7h  Error  on  Fixed  Size  Form 
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Figure  5-7 i  Add  Open-ended  Form 
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Figure  5-71  Form  ffll  with  One  Element 


Press  <Enter> 


Press  <Enter> 


J 


Figu'e  5-7n  Form  ffll  with  Three  Elements 


Press  <Enter> 
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Figure  5-7p  Form  ffll  with  Five  Elements 


0 
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Figure  5-7s  Form  ffll  Showing  Fifth  Element 
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Add  • 


Figure  5-7t  Add  Data  in  Sixth  Element 


'  as  shown  in  Form  ffll 
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Figure  5-7u  Remove  Form  ffll 


Press  <Mode>  Key  to  return  to  application  mode  then  enter  screen 
as  shown. 
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Figure  5-8a  Test  ADDFRM 
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Figure  5-8b  Form  ffS  in  W3 
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Figure  5-8c  Add  Another  Form 
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Figure  5“8d  Form  ff2  in  W3 
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Figure  5-9b  Form  ff3  in  W3 
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Figure  5-lOb  W3  with  Page  Removed 


5- 


UTP620344200 
30  September  1990 


UTP620344200 
30  September  1990 


Figure  5-llb  GPAGE  Result 
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Figure  5-12b  GWINDO  Result 
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Figure  5-13b  W3  with  Form  ff9 
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Figure  5- 14b  W3  with  Page  2  Removed 
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Figure  5-aso 


Porm  ffg 


Already  closed 
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Figure  5-16a  Test  PDATA 
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Figure  5-18b  PDATA  Result 
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Figure  5-19a  Test  GDATA  (Previous  Instance) 
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Figure 
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Enter  "xx"  as  shown  in  form 


UTP620344200 
30  September  1990 


Figure  5-2 Ob  GDATA  (Previous  Instance) 
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Figure  5-21a  GDATA  (Current  Instance) 
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Figure  5-2 lb  Current  Value  in  Form  ff6 


5-6: 


UTP620344200 
30  September  1990 


Figure  5-2 2a  Test  GETATT 
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Figure  5-2 2b  GETATT  Result 
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Figure  5-2 3b  PUTATT  Result 
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Figure  5-24a  Test  PUTATT  (TEXT) 
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Figure  5-24b  PUTATT  Result 


5-73 


UTP620344200 
30  September  1990 


Figure  5-25a  Test  PUTBAK  (WHITE) 
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Figure  5-2 5b  PUTBAK  Result 
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Figure  5-2 6a  Test  GETBAK 
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Figure  5-2 6b  GETBAK  Result 
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Figure  5-27a  Change  Attribute 
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Figure  5-28a  Change  Form  ff5  Background 
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Figure  5-28b  Form  ffS  Background  Black 
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Figure  5-29a  Test  PUTCUR 
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Figure  5-29c  Current  Cursor  Position 


UTP620344200 
30  September  1990 


Figure  5-3 Oa  Test  PARFQN 
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Figure  5-3 la  Test  Terminal  in  Terminal 
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Figure  5-3 2b  Test  GETDQN 
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Figure  5-3 2c  GETDQN  Result 
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32f  Reset  Default  Qualified  Name 
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Figure  5-32h  Path  Not  Unique 


UTP620344200 
30  September  1990 


Figure  5-3 3a  Enter  Test  Data 
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Figure  5-341  Page  Up 


Press  PF9  (page  up) 


LtM 
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Figure  5-34o  Scrolling  Ended 
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Figure  5-3 5b  INQLDV  Result 


Logical  device  numbers  are  determined  at  run  time.  Substitute 
the  number  you  get  (if  it's  not  *5')  wherever  *5'  appears  in  the 
remainder  of  this  test. 
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Figure  5-3 6a  Test  GETLDV 
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Figure  5-37a  Test  SETLDV  (Smaller) 
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Figure  5-3 8a  Test  SETLDV  (Larger) 
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Figure  5-3 8b  SETLDV  Result 
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Figure  5-39a  Test  OPNLDV 
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Figure  5-3 9b  OPNLDV  Result 


Logical  device  numbers  are  determined  at  run  time.  Substitute 
the  number  you  get  (if  it's  not  '26')  wherever  '26'  appears  in 
the  remainder  of  this  test. 
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Figure  5-4 Oa  Test  CHGLDV 
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All  fields  non-enterable. 

Press  <Mode>  key  to  get  into  window  manager  mode. 

I 

i 
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Figure  5-41a  Select  Application 


Press  PF14  (Select  AP) 
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Figure  5-42b  Size  Result 
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Figure  5-43a  Test  Location  Key 


Position  cursor  as  shown  and  press  PFIO  (Location) 
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Figure  5-4 3b  Location  Result 
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Figure  5-44a  Add  Form  ffl 
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Figure  5-44b  Form  ffl  Added 
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Figure  5-4 5a  Test  Select  Window 


Position  cursor  on  'C  in  'Command  L*  below  form  ffl  and 
press  PFll  (Select  Window) . 
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Figure  5-4 5b  Select  Window  Result 


5-137 


CO 

CO 


UTP620344200 
30  September  1990 


Figure  5-4 6b  Page  Up  Result 
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Leave  the  cursor  positioned  as  shown  on  the  screen  and  press  PF6 
(Page  Down) . 
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Figure  5 -4 7b  Page  Down  Result 


Press  PF15  (Home  View) , 
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Figure  5-4 7c  Home  View  Result 
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Figure  5-4 8b  Page  Left  Result 
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Figure  5-49a  Test  Page  Right 


Position  cursor  on  'L'  in  'Line'  below  form  ffl  and  press  PF8 
(page  right) . 
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Figure  5-4 9b  Page  Right  Result 


Press  PF12  (unselect  window) 
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Figure  5-50a  Test  APSTAT 


Press  PF6  (APSTAT)  to  display  Application  Status  Form 
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Figure  5-50b  Application  Status  Form 


The  Device  Type  field  value  may  be  different  than  shown  in  this 
figure.  This  value  is  assigned  by  the  NTM  at  run  time. 
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Figure  5-50c  Manually  Test  Move  LDV 


Change  form  as  shown  and  press  <ENTER>.  NOTE:  ’SDPRINTERZ'  and 
•PRINT. DEV  must  be  entered  in  upper  case  for  this  release. 


5-150 


UTP62034420C 
30  September  1990 


Figure  5-50d  Move  LDV  Result 


Press  PF6  (APSTAT)  PF6  to  display  Application  Status  Form. 
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Figure  5-51a  Application  Status  Form 
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Figure  5-5 Ic  Return  LDV  Result 
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Figure  5-52b  MOVLDV  Result 


Press  PF6  (APSTAT)  to  display  Application  Status  Form. 
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Figure  5-52c  Application  Status  Form 
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Figure  5-53b  Return  LDV  Result 


Press  <Mode>  key  to  get  into  window  manager  mode  and  press  PF14 
(SELECT  AP) . 
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Figure  5-54a  Test  CLSLDV 
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Figure  5-54b  CLSLDV  Result 


Press  PF13  (FUNCTION) 


5-163 


UTP620344200 
30  September  1990 


Figure  5-54c  IISS  Function  Screen 
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Figure  5-55a  Start  MM 
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Figure  5-55b  IISS  Function  Screen 
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Figure  5-56a  Start  TE 
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Figure  5-57a  Application  Status  Form  after  Aborting  TE 


Press  <QUIT>. 
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Figure  5“58a  Abort  Result 


Press  <QUIT>. 
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Figure  5-58b  IISS  Function  Screen 
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Figure  5-59b  First  ARTEST  Screen 


Press  the  <MODE>  key  to  return  to  application  mode. 
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Figure  5-60b  W3  with  Form  ffl2 
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Figure  5-61b  Form  ffl2  Item  with  Data 
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Figure  5-62b  W1  with  Form  ffl3 


Press  the  <MODE>  key  to  get  into  Text  Editor  mode. 
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Figure  5-62c  Text  Editor  Mode 


Position  the  cursor  on  the  "n”  in  ”1  line"  and  press  PF13 
(MIDLINE  BREAK) . 
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Figure  5-63  Midline  Break  Result 


Press  PFIO  (DELETE  LINE) . 
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Figure  5-68  Paste  Result 


Press  PF14  (DELETE  ITEM) . 
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Figure  5-70  Fill  Result 


Position  cursor  below  the  ”o"  in  Command  and  press  PF12  (FILL) . 
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Figure  5-71  Copying  an  Item  Value  Using  Fill 


Positon  the  cursor  back  in  W3  and  press  PF15  (RESTORE) . 
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Figure  5-73  ! 


Enter  "line"  and  press  <ENTER>. 
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Figure  5-74a  Forwards  Search  Result 


The  cursor  should  be  positioned  on  "line"  after  the  "1"  in  w3. 
Press  PF6  (SEARCH  NEXT) . 
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Figure  5-7 4b  Search  Next  Result 


The  cursor  should  be  positioned  on  "line"  after  the  "2"  in  w3. 
Press  PF6  (SEARCH  NEXT) . 
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Figure  5-74c  Search  Next  Result 


The  cursor  should  be  positioned  on  "line"  after  the  "3"  in  w3. 
Press  PF6  (SEARCH  NEXT) . 
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Figure  5-7 6a  Backwards  Search  Result 


The  cursor  should  be  positioned  on  "line"  after  the  "2"  in  w3 
Press  PF6  (SEARCH  NEXT) . 
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Figure  5-7 6b  Search  Next  Result 


The  cursor  should  be  positioned  on  "line"  after  the  "1"  in  w3. 
Press  PF6  (SEARCH  NEXT) . 
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Figure  5-76c  String  Not  Found 


Press  PF5  (SEARCH) . 
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Figure  5-78  Search  Result 


The  cursor  should  be  positioned  on  "line"  after  the  "2"  in  w3. 
Press  PF7  (REPLACE) . 
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Figure  5-84 


Fill  Result 


Press  PF17  (MARGINS). 
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Figure  5-95  IISS  Function  Screen 
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Figure  5-96a  Restart  ARTEST  Application 
Enter  "ARTEST”  as  shown  and  press  <ENTER>. 
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Figure  5-9 6b  First  ARTEST  Screen 
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Figure  5-97a  ADDFLD  Test  Case  1 


Create  a  new  input  item  field  named  i2  of  size  1  by  1  and  add  it 
to  the  form  ff4.  The  fields  position  is  offset  1  row  and  2 
columns  from  the  upper  left  corner  of  the  containing  forms. 
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Figure  5-97b  Case  1  Result 


Since  the  form  ff4  is  a  repeating  form  field,  the  field  i2  is 
added  to  both  instances  of  the  form. 
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Figure  5-98a  ADDFLD  Test  Case  2 


Create  a  new  input  item  field  named  i3  of  size  1  by  1  and  add  it 
to  the  form  ff4.  The  field  is  positioned  relative  to  12. 


* 
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Figure  5-99a  CRTFLD  Test  Case 


Create  a  field  named  f£5_i2  on  the  form  ffS.  Define  no  other 
properties  of  the  field  at  this  time.  There  are  no  changes  in 
the  terminal  screen  at  this  time. 
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Figure  5-99b  Specify  Field  Location 


Use  SETLOC  to  define  the  location  of  ff5_i2  to  be  offset  2  rows 
and  3  columns  from  the  upper  left  corner  of  the  containing  form. 
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Figure  5-99c  Specify  Field  Display  Attribute 


Use  SETDIS  to  define  the  display  attribute  of  the  field  ff5_i2 
to  be  input. 
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Figure  5-99d  Test  Case  Result 
The  field  is  now  visible  on  form  ffS. 
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Figure  5- 100a  REPFLD  Test  Case 


Create  a  copy  of  the  item  field  il  on  form  ff8.  Name  the  field 
i2  and  attach  it  to  form  ffS  without  giving  it  a  location. 

There  will  be  no  changes  on  the  terminal  screen  at  this  time. 
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Figure  5-lOOb  Specify  an  Absolute  Field  Location 

Use  SETLOC  to  position  the  field  i2  on  form  ffS  1  row  and  1 
column  from  the  upper  left  corner  of  ff5. 
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Figure  5-lOOc  Test  Case  Result 


The  field  is  now  visible  on  form  ffS. 
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Figure  5-lOla  MVRFLD  Test  Case 


Copy  a  field  and  define  the  position  to  be  offset  1  row  and  1 
column  from  the  origin  of  form  ff6. 
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Figure  5-lOlb  Test  Case  Result 


The  original  field  is  il  on  form  ffS.  The  copy  is  named  i2  and 
now  appears  on  the  form  ff6. 
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Figure  5-102  RMVFLD  Test  Case  with  Result 


Remove  field  i2  from  form  ff6.  The  form  ff6  appears  as  it  did 
before  calling  MVRFLD. 
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Figure  5-103a  REPFRM  Test  Case 


Create  a  copy  of  the  form  ff4  and  call  it  ff42.  There  will  be 
no  changes  on  the  terminal  screen  at  this  time. 
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Figure  5-103b  Test  Case  Result 


The  form  is  added  to  the  window  W3  so  that  it  becomes  visible 
and  you  can  see  that  the  form  copy  was  actually  created.  Note 
that  only  a  single  instance  of  ff4  appears. 
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Figure  5-104a  CRTFRM  Test  Case 


Create  a  form  named  £f54.  There  will  be  no  changes  on  the 
terminal  screen  at  this  time. 
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Figure  5-104b  Add  a  Field  to  the  Form 


Use  AOOFLD  to  add  an  input  item  field,  il,  to  the  form  ff54. 
Its  position  is  offset  0  rows  and  1  column  from  the  origin  of 
ff54.  There  will  be  no  changes  on  the  terminal  screen  at  this 
time. 
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Figure  5-104C  Test  Case  Result 


The  form  is  added  to  the  window  W3  so  that  it  becomes  visible 
and  you  can  see  that  it  was  actually  created. 
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The  form  ff59  is  added  as  a  form  field  to  the  form  ff5  with  a 
position  offset  2  rows  and  8  colimns  from  the  origin  of  ffS  to 
show  that  it  was  actually  created. 
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Figure  5-106a  GDPFEX  Test  Preparation 


Use  RPLFKM  to  replace  the  current  form  in  page  1  of  w3  with  form 
ffl4. 
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Figure  5-106b  RPLFRM  Result 
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Figure  5-106c  Set  Value  of  Item  il 
Use  PDATA  to  set  the  value  of  the  item  field  il  on  ffl4  to  ”17”. 
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Figure  5-106d  PDATA  Result 
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Figure  5-107a  GDPFEX  Test  Case  1  with  Result 


Get  the  first  field  in  the  form  ff 14  which  has  a  VALUE  clause 
referring  to  the  item  field  il.  It  is  i2. 
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Figure  5-107b  GDPFEX  Test  Case  2  with  Result 


Get  the  second  field  in  the  form  ffl4  which  has  a  VALUE  clause 
referring  to  the  item  field  il.  There  is  no  such  field.  The 
form  ffl4  only  contains  one  field  that  has  a  value  clause 
expression  referring  to  item  il. 
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Figure  5-107c  GDPFEX  Test  Case  3  with  Result 

Get  the  last  field  in  the  list  of  fields  whose  value  depends  on 
the  item  field  il.  Since  there  is  only  one  such  field,  i2,  this 
field  name  is  returned. 
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Figure  5-108  GDPFLC  Test  Case  with  Result 


Get  the  first  field  in  the  form  ffl4  which  has  a  location  clause 
referring  to  the  item  field  il.  The  first  such  field  is  i3. 

The  location  of  i3  is  relative  to  il. 
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Figure  5-109a  GFMFLD  Test  Case  1  with  Result 


Get  the  first  field  belonging  to  the  form  ff3.  The  name  of  this 
field  is  il,  and  it  is  an  item  field. 
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Figure  5-109c  GFMFLD  Test  Case  3  with  Result 


Get  the  ninth  field  belonging  to  the  form  ffl.  The  name  of  this 
field  is  ff3,  and  it  is  a  form  field. 
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Figure  5-1 09d  GFMFLD  Test  Case  4  with  Result 


Get  the  next  to  the  last  field  belonging  to  the  form  ffl.  The 
name  of  this  field  is  ffS,  and  it  is  *a  form  field. 
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Figure  5-109e  GFMFLD  Test  Case  5  with  Result 


Get  the  field  belonging  to  the  form  ffl  which  is  twelfth  from 
the  last.  The  name  of  this  field  is  i4,  and  it  is  an  item 
field. 
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Figure  5-llOa  ADDDIM  Test  Case 


Add  a  repeat  specification  to  the  item  field  il  in  the  form  ffs 
which  indicates  that  il  repeats  vertically  twice  with  no  spaces 
and  that  both  instances  are  actually  displayed. 
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Figure  5-llOb  Test  Case  Result 


The  box  below  the  "form  ffS”  shows  the  result  of  making  il  an 
array. 
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Figure  5-1 11a  SETDOM  Test  Case  1 


Establish  a  domain  clause  for  the  repeating  item  field  il  on  the 
form  ffS.  Define  il  to  be  a  roust  enter,  right  justified, 
numeric  field  with  a  minimum  value  of  10  and  a  maximum  value  of 
20. 
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Figure  5-lllb  Test  Verification 

A  data  value  of  "abc"  is  entered  in  the  item  field  il  on  form 
ffS. 


5-262 


UTP620344200 
30  September  1990 


Figure  5- 111c  Domain  Check  Result 


The  value  is  right  justified  but  since  "abc"  is  not  numeric,  an 
error  message  is  issued. 
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Figure  5-llld  Invalid  Value  with  Result 


Entering  an  out  of  range  numeric  value  results  in  an  error 
message  in  the  message  line. 
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Figure  5-llle  Valid  Value  with  Result 


The  value  "11"  satisfies  all  of  the  domain  constraints  and  is 
accepted  as  a  valid  value. 
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Figure  5-112a  RMVDIM  Test  Case 
Remove  the  array  dimension  from  item  field  il  on  form  ffS. 
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Figure  5-112b  Test  Case  Result 


The  form  ffS  now  only  contains  one  occurrence  of  the  item  field 
il. 
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Figure  5-113a  SETDOM  Test  Case  2 


Redefine  the  item  field  il  on  the  form  ffs  to  be  a  required 
entry  character  field  that  is  to  be  left  justified  and  shifted 
to  upper  case. 
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Figure  5-113b  Test  Verification 


Pressing  the  <ENTER>  key  without  entering  any  data  results  in 
the  message  that  data  must  be  entered  in  the  field. 
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Figure  5-113C  Data  Value  "abc”  Entered 
The  character  string  "abc”  is  entered  in  the  field  il. 
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Figure  5-113d  Domain  Check  Result 


As  per  the  domain  clause,  the  string  "abc"  is  shifted  to  upper 
case  and  left  justified. 
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Figure  5-114b  Case  1  Result 


The  prompt  ''window_l''  appears  centered  one  line  above  wl. 
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Figure  5- 114c  SETPRO  Test  Case  2 


Define  a  background  prompt  for  the  form  ffs  at  the  position 
offset  1  row  and  1  column  from  the  upper  left  corner  of  ffS. 
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Figure  5-114d  Case  2  Result 

The  prompt,  "blnk  line",  appears  below  the  prompt,  "form  ff8". 
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Figure  5-114e  SETPRO  Test  Case  3 


Attach  a  prompt  to  the  window  field  w3  on  ffl  that  is  positioned 
relative  to  w3,  centered  vertically  and  offset  2  horizontally. 
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Figure  5-115a  SETATT  Test  Case 
Define  an  attribute  clause  for  ’’input”  on  the  form  ff3. 


5-278 


UTP620344200 
30  September  1990 


Figure  5-115b  Test  Case  Result 


The  item  il  on  ff3  has  the  display  attribute  "input"  and 
now  shows  the  properties  defined  for  this  attribute:  a 
foreground  color  of  white  and  background  color  of  black.  It  is 
also  bold,  underscore,  slowblink,  reverse,  and  tabfield. 
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Figure  5-116a  SETDIS  Test  Case  1 


Define  the  display  attribute  of  item  il  on  form  ff3  to  be 
output . 
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Figure  5-116b  Case  1  Result 


Since  the  field  il  contains  no  data,  it  does  not  appear  on  the 
form  ff3. 
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Figure  5-116c  Return  Attribute  to  Input 
Use  SETDIS  again  to  reset  il's  display  attribute  to  input. 
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Figure  5-116e  Case  2  Result 


This  makes  all  four  occurrences  of  the  window  visible  against 
the  black  background  of  the  containing  form,  ffl. 
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Figure  5-117a  SETHLP  Test  Case  1 


Define  the  help  for  the  item  field  il  on  form  ff3  to  be 
application  help. 
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Figure  5-117b  Case  1  Result 


Positioning  the  cursor  in  item  field  il  and  pressing  the  <HELP> 
key  causes  the  message  to  appear  in  the  message  line. 


5-286 


UTP620344200 
30  September  1990 


Figure  5-117c  SETHLP  Test  Case  2 


Help  for  the  item  field  il  on  form  ff3  is  defined  to  be 
that  will  be  displayed  in  the  message  line. 


string 
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Figure  5-117d  Case  2  Result 


Positioning  the  cursor  in  item  field  il  and  pressing  the  <HELP> 
key  causes  the  message  to  appear  in  the  message  line.  Press  the 
<ENTER>  key  to  continue. 
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Figure  5-117e  SETHLP  Test  Case  3 


Help  for  the  item  field  il  on  form  ff3  is  defined  to  be  the  form 
ff2. 
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Figure  5-117f  Case  3  Result 


When  the  cursor  is  in  the  item  field  il  on  the  form  ff3  and  the 
<HELP>  key  is  pressed,  the  form  ffl  is  replaced  by  the  form  ff2 
on  the  terminal  screen.  Press  the  <QUIT>  key  to  return  to 
ARTEST  and  then  press  the  <ENTER>  key  to  continue. 
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Figure  5-118a  SETLOC  Test  Case  1 


Change  the  location  of  the  item  field  i2  on  the  form  ff2. 
Define  it  to  be  positioned  relatively  to  the  first  and  second 
occurrences  of  il. 
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Figure  5-118b  Case  1  Result 


The  item  field  i2  appears  1  row  below  il(l)  and  3  columns  to  the 
right  of  the  left  edge  of  il(2). 
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Figure  5-118d  Case  2  Result 

The  item  field  i2  is  placed  a  row  3  and  column  3  on  form  ff2. 
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Figure  5-119a  SETNAM  Test  Case  1 


Change  the  name  of  the  item  field  il  on  ff8  to  be  i2. 
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Figure  5-119b  Test  Verification 


Use  PDATA  to  insert  data  into  the  item  field  now  named  i2. 
verifies  that  the  name  change  was  successful. 


This 
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Figure  5-12 Oa  SETDIM  Test  Case 


Form  ff3  currently  contains  the  item  field  il  that  repeats  twice 
horizontally  and  then  this  array  is  repeated  twice  vertically. 
The  vertical  repetition  is  changed  to  be  1  displayed  instance 
and  2  actual  instances. 
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Figure  5-12 la  SETTYP  Test  Case  1 
Change  the  form  field  ff3  on  the  form  ffl  to  an  item  field. 
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Figure  5-122a  SETSIZ  Test  Case  1 
Change  the  size  of  the  field  ff3  on  the  form  ffl  to  be  4  by  4. 
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Figure  5-122b  Case  1  Result 


The  reorganization  of  the  data  in  £f3  shows  that  the  size  was 
changed. 
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Figure  5-122d  Case  2  Result 


The  data  contained  in  ff3  are  reorganized  to  reflect  the  size 
change . 
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Figure  5-124a  SETSI2  Test  Case  3 


Change  the  size  of  the  item  field  il  on  form  ff3  to  be  2  by  1 
instead  of  3  by  1. 
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Figure  5-124b  Case  3  Result 


Since  il  is  an  item  array,  the  size  is  changed  on  all  instances 
of  il. 
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Figure  5-124c  SETSIZ  Test  Case  4 


Increase  the  size  of  item  il  on  form  ff3  to  be  larger  than  the 
original  size  of  3  by  1. 
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Figure  5-124d  Case  4  Result 


Again,  the  size  is  increased  to  4  by  1  on  all  instances  of  il  in 
the  form  ff3. 
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Figure  5-12 5a  SETTYP  Test  Case  3 


Change  the  form  field  ff7  on  the  form  ffl  a  window  field. 
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Figure  5-125c  Test  Verification 


To  verify  that  field  ff7  is  now  a  window  field,  use  ADDFRM  to 
add  the  form  ff3  to  it. 
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Figure  5-12 5d  ADDFRM  Result 
Form  ff3  does  appear  where  the  form  ff7  was. 
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Figure  5-126a  SETVAL  Test  Case  1 


Define  a  VALUE  clause  for  the  item  field  il  on  the  form  ffl4 
which  is  displayed  in  window  w3. 
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Figure  5-127a  SETVAL  Test  Case  2 


Define  the  value  of  the  item  i2  on  ff8  to  be  the  built-in  TIME 
function. 
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Figure  5-127b  Case  2  Result 


The  current  time  appears  in  the  item  field  i2  on  form  ffs. 
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Figure  5-128a  SETVAL  Test  Case  3 


Define  the  value  of  the  item  field  il  on  the  form  ff3  to  be  the 
expression  "12”  +  2. 
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Figure  5-128b  Case  3  Result 


Since  the  item  field  il  is  a  repeated  field  on  the  form  ff3,  the 
result  of  evaluating  the  expression,  14,  is  placed  in  each  array 
instance.  This  test  also  shows  that  the  appropriate  conversion 
is  done  to  perform  the  arithmetic. 
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Figure  5-129a  INQABS  Test  Case  1  with  Result 


the  absolute  position  of  window  w3  on  the  form  ffl.  It 
3  and  column  60. 
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Figure  5-129c  INQABS  Test  Case  3  with  Result 


Return  the  absolute  position  of  form  ff2  on  form  ffl.  It  is  row 
12  and  column  1. 
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Figure  5-130a  INQATT  Test  Case  1  with  Result 


Return  the  first  attribute  defined  for  the  form  ffl.  It  is 
BLACKFG. 
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Figure  5-130b  INQATT  Test  Case  2  with  Result 


Inquire  what  the  display  color  associated  with  the  attribute 
BLACKFG  is.  It  is  black. 
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Figure  5-13 Oc  INQATT  Test  Case  3  with  Result 


Inquire  what  the  background  color  associated  with  the  attribute 
BLACKFG  is.  It  is  white. 
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Figure  5-13 la  INQDIS  Test  Case  1  with  Result 


Return  the  background  color  attribute  for  ffl.  It  is  BLUE, 
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Figure  5-13 lb  INQDIS  Test  Case  2  with  Result 


Return  the  background  color  attribute  for  the  window  w2  on  the 
form  ffl.  It  is  XPARNT. 
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Figure  5-13 Ic  INQDIS  Test  Case  3  with  Result 


Return  the  background  color  attribute  for  the  form  ff2  on  the 
form  ffl.  It  is  XPARNT. 
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Figure  5-13 le  INQDIS  Test  Case  5  with  Result 


Inquire  what  is  the  display  attribute  for  a  non-existent  field, 
i99,  on  form  ffl.  The  message  "Field  not  found"  is  sent  to  the 
message  line. 
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Figure  5-13 If  INQDIS  Test  Case  6  with  Result 


Inquire  what  the  display  attribute  is  for  a  field  on  a 
nonexistent  form,  ff56.  The  message  "Form  not  found"  is  sent  to 
the  message  line. 
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Figure  5-132  INQDOM  Test  Case  with  Result 


Return  the  entire  DOMAIN  clause  associated  with  the  item  field 
i2  on  form  ff2.  It  is  NUMERIC,  MINIMUM  1,  MAXIMUM  6. 
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Figure  5-133a  INQHLP  Test  Case  1  with  Result 


Inquire  what  the  "help"  associated  with  the  item  field  il  on 
form  ff4  is.  The  help  for  this  field  is  the  string  "This  is  a 
help  string" . 


5-335 


c  o 


UTP620344200 
30  September  1990 


Figure  5-133b  INQHLP  Test  Case  2  with  Result 


ire  what  is  "help"  associated  with  the  item  field  il  on  the 
f£5  is.  The  help  has  defined  to  be  application  help. 
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Figure  5-133c  INQHLP  Test  Case  3  with  Result 


Inquire  what  is  the  "help"  associated  with  the  item  field  i4  on 
the  form  ffl.  The  help  xs  the  form  PATHCOM. 
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Figure  5-134a  INQLOC  Test  Case  1  with  Result 


Return  the  location  of  the  item  field  i3  on  the  form  ffl4.  The 
location  is  specified  relative  to  the  field  il  and  is  adjacent 
to  il. 
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Figure  5-134b  INQLOC  Test  Case  2  with  Result 


Return  the  location  of  the  item  field  i4  on  the  form  ffl.  The 
position  of  field  i4  is  offset  1  row  19  columns  from  the  origin 
of  ffl. 
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Figure  5-13 5b  Display  the  Form  Test 
Add  the  form  test  to  window  w3. 
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Figure  5-135c  Add  First  Prompt 
Add  the  form  prompt  "test”. 
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Figure  5-135e  Add  Third  Prompt 


Add  another  form  prompt  "test”. 
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Figure  5-136a  INQPRO  Test  Case  1  with  Result 

Return  the  first  prompt  string  attached  to  the  form  test.  It  is 
the  string  "test".  The  location  of  the  prompt  is  also  returned 
and  is  0  rows  and  1  column  from  the  upper  left  corner  of  the 
form  test. 
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Figure  5-13 6b  INQPRO  Test  Case  2  with  Result 


Return  the  second  prompt  string  attached  to  the  form  test.  It 
is  the  string  "abed".  The  location  of  the  prompt  is  also 
returned  and  is  1  row  and  1  column  from  the  upper  left  corner  of 
the  containing  form. 


5-346 


UTP620344200 
30  September  1990 


CoMand  Un*  jlnqprc  ««st  * 

vlndovS  1 

■  "—‘g 

4 

- him  HT" 

1 

i 

toil 

•bed 

tut 

<-v3 

1 

1 

i 

ion  ii: 

for*  ff2 

(01  > 

fl3 

lor*  1  for* 

((« 

forr,  2(3  || 

L  *  . 

UJ 

Tun 

II 

li 

•  1 14  1  1 

^  n 

1 

fo»  UI. 

(err  (IS 

«  , 

blni  lift* 

l<i;o::2t  1 

Hors  at. 

I  !  !  1 

— S’ 

II 

lun*  23 

... 

. I 

|liSC:(  3[Inva2id  ladti  apaelfiad 

aspleatiOA 

Figure  5-136c  INQPRO  Test  Case  3  with  Result 


Inquire  about  a  nonexistent  prompt  string  on  the  form  test, 
error  message  "Invalid  Index  Specified"  is  returned. 


The 
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Figure  5-138a  INQDIM  Test  Case  1  with  Result 


Return  the  first  repeat  specification  of  the  field  ff4  on  the 
form  ffl.  The  form  ff4  is  repeated  vertically  twice  with  one 
intervening  space  and  both  elements  are  displayed. 
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Figure  5-138b  INQDIM  Test  Case  2  with  Result 


Inquire  about  a  nonexistent  repeat  specification.  The  error 
message  "Array  Not  Found"  is  displayed  in  the  message  line. 
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Figure  5-139a  INQSIZ  Test  Case  1  with  Result 


Return  the  SIZE  specification  for  the  item  field  il  on  the  form 
ff3.  The  field  has  a  width  of  4  and  a  depth  of  1. 
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Figure  5-139b  INQSIZ  Test  Case  2  with  Result 


Return  the  SIZE  specification  of  the  form  field  ff3  on  the  form 
ffl.  The  field  has  a  width  of  10  and  a  depth  of  4. 
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Figure  5-139c  INQSIZ  Test  Case  3  with  Result 


Return  the  SIZE  specification  of  the  window  field  w2  on  the  form 
ffl.  The  field  has  a  width  of  10  and  a  depth  of  4. 
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Figure  5-14 Oa  INQTYP  Test  Case  1  with  Result 


Inquire  what  type  of  the  field  ff2  on  the  form  ffl  is.  The  type 
returned  is  ”F"  for  form. 
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Figure  5-140b  INQTYP  Test  Case  2  with  Result 


Inquire  what  the  type  of  the  field  iO  on  the  form  ffl  is. 
type  returned  is  "I"  for  item. 


The 
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Figure  5-14 Oc  INQTYP  Test  Case  3  with  Result 


Inquire  what  type  of  the  field  w2  on  the  form  ffl  is.  The  type 
returned  is  "W"  for  window. 
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Figure  5-141  INQVAL  Test  Case  with  Result 


Return  the  VALUE  clause  defined  for  the  item  field  i3  on  the 
form  ffl.  The  result  is  '•Display:". 
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Figure  5-14 2a  RMVATT  Test  Case  1 


Remove  the  ATTRIBUTE  clause  defining  the  attribute  BLACKFG  for 
the  form  ffl. 
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Figure  5-14 2b  Verify  Case  1  Result 


The  INQATT  routine  is  used  to  verify  that  the  attribute 
definition  for  BLACKFG  has  been  deleted.  BLACKFG  was  formerly 
the  first  attribute  associated  with  form  ffl.  The  first 
attribute  is  now  REDFG. 
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Figure  5-142C  RMVATT  Test  Case  2 


Remove  the  ATTRIBUTE  clause  defining  REDFG  as  an  attribute 
associated  with  the  form  ffl. 
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Figure  5-142d  Verify  Case  2  Result 


The  INQATT  routine  is  used  to  verify  that  the  attribute 
definition  for  REDFG  has  been  deleted.  This  time  the  background 
color  belonging  to  the  attribute  REDFG  is  requested.  The 
message  "Attribute  does  not  exist"  is  issued  proving  the 
attribute  definition  has  been  deleted. 
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Figure  5-143  RMVDIM  Test  Preparation 
Add  the  form  ff3  to  window  w3. 
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Figure  5-144a  RMVDIM  Test  Case 


The  first  repeat  specification  for  the  window  field  w2  on  the 
form  ffl  is  removed. 
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Figure  5-144b  Test  Result 


Only  the  second  repeat  specification,  horizontal  repetition, 
remains  for  the  field  w2. 
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Figure  5-14 5a  RMVDOM  Test  Case 


Remove  the  domain  clause  defined  for  the  item  field  i2  on  the 
form  ff2.  The  INQDOM  test  in  Figure  5-132,  show  that  the  domain 
options  for  this  field  are  defined  as  NUMERIC,  MINIMUM  1, 

MAXIMUM  6. 
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Figure  5-145b  Verify  Test  Result 


Inquire  what  the  domain  clause  defined  for  the  item  field  il  on 
the  form  ff2  is  after  having  deleted  it.  The  message  "Value 
Clause  Not  Found"  is  issued  verifying  that  the  IX)MAIN  clause  has 
indeed  been  dropped. 
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Figure  5-146  RMVHLP  Test  Preparation 


Position  the  cursor  in  the  item  field  il  on  the  form  ff4  and 
press  the  <HELP>  key  to  obtain  the  help  associated  with  the 
field.  The  "help"  is  a  text  string  "This  is  a  help  string". 
Press  the  <ENTER>  key  to  continue. 


UTP620344200 
30  September  1990 


Figure  5-147a  RMVHLP  Test  Case 


Remove  the  help  information  defined  for  the  item  field  il  on  the 
form  ff4. 
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Figure  5-147b  Verify  Test  Result 


Inquire  what  help  is  defined  for  the  item  field  il  on  ff4  using 
INQHLP.  The  message  "No  help  available"  verifies  that  the  help 
has  been  deleted. 
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Figure  5-148a  RMVARY  Test  Case 


Remove  the  entire  repeat  specification  for  the  item  field  il  on 
the  form  ff3. 
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Figure  5-149  RMWAL  Test  Preparation 


Use  INQVAL  to  first  obtain  the  VALUE  clause  defined  for  the  item 
field  iO  on  the  form  ffl.  It  is  defined  as  the  string  "form 
ffl". 
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Figure  5-150a  RMWAL  Test  Case 


Remove  the  VALUE  clause  defined  for  the  item  field  iO  on  the 
form  ffl. 
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Figure  5-150b  Verify  Test  Case 


The  value  of  the  item  field  still  displays  as  "form  ffl"  because 
no  new  data  have  been  assigned  to  it.  Use  PDATA  to  assign 
blanks  to  iO. 
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Figure  5-150c  Test  Case  Result 
The  "form  ffl”  value  in  field  iO  is  now  gone. 
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Figure  5-150d  Another  RMWAL  Verification 


Use  INQVAL  to  verify  that  the  VALUE  clause  has  been  removed. 
This  is  shown  by  the  error  message  "Value  Clause  Not  Found". 
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Figure  5-151a  SAVFRM  Test  Case  1 


The  definition  of  the  form  ffl  is  to  be  compiled  and  written  out 
in  compiled  (FD)  form. 
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Figure  5-151b  SAVFRM  Test  Case  2 


The  definition  of  the  form  ffl  is  to  be  compiled  and  written  out 
in  both  compiled  (FD)  form  and  in  source  (FDL)  form. 
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Figure  5-151c  SAVFRM  Test  Case  3 


The  definition  of  the  form  ffl  is  to  be  written  out  in  source 
(FDL)  form. 
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Figure  5-152  APRFLD  Test  Preparation 


Use  RPLFRM  to  display  form  ffl4  in  window  w3.  This  form 
contains  three  item  fields.  12  is  an  output  field  whose 
is  defined  to  be  il  and  i3  is  displayed  depending  on  the 
of  its  APPEARS  IF  clause. 


value 

value 
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Figure  5-153a  APRFLD  Test  Case  1  with  Result 

Set  the  display  flag  to  nondisplay.  Item  i3  does  not  appear  on 
the  screen. 
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Figure  5-153b  APRFLD  Test  Case  2  with  Result 
Set  the  display  flag  to  display.  Item  i3  appears  on  the  screen. 
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Figure  5-153c  APRFLD  Test  Case  3  with  Result 


Toggle  the  display  flag.  Item  i3  does  not  appear  on  the  screen. 
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Figure  5-153d  APRFLD  Test  Case  4  with  Result 
Toggle  the  display  flag.  Item  i3  appears  on  the  screen. 
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Use  RPLFRM  to  display  the  form  ff20  in  window  w3.  Item  i3  does 
not  appear. 
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Figure  5-155  INQAPR  Test  Case  1  with  Result 


Find  out  what  the  current  appears  if  criterion  defined  for  item 
i3  is.  It  appears  if  the  value  of  il  is  greater  than  10. 
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Figure  5--156  SETAPR  Error  Test 


Enter  an  invalid  expression  for  the  appears  if  criterion, 
message  "Error  in  expression"  is  displayed. 


The 


5-388 


UTP620344200 
30  September  1990 


Figure  5-157  SETAPR  Test  Case  with  Result 


Define  the  appears  if  criterion  for  item  i3  to  be  not  il  greater 
than  10.  Since  the  value  of  il  is  blank,  i3  appears. 
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Figure  5-158  INQAPR  Test  Case  2  with  Result 

Use  INQAPR  to  verify  the  appears  if  criterion  defined  for  i3. 
The  message  "Field  value  too  long  -  truncated"  is  displayed 
because  a  buffer  size  of  5  is  not  long  for  the  expression. 
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Figure  5-159  INQAPR  Test  Case  3  with  Result 


Use  INQAPR  again  with  a  larger  buffer  size.  The  criterion 
defined  previously  using  SETAPR  is  returned. 
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Figure  5-160  RMVAPR  Test  Case  1  with  Result 


Use  RMVAPR  to  delete  the  appears  if  criterion  defined  for  an 
item  field.  In  this  case,  il  does  not  have  any  criterion 
defined.  The  message  "Value  clause  not  found"  is  displayed. 
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Figure  5-161  RMVAPR  Test  Preparation 
Use  PDATA  to  enter  the  value  ”20  ”  in  il  so  that  i3  disappears. 
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Figure  5-162  RMVAPR  Test  Case  2  with  Result 


Remove  the  appears  if  criterion  defined  for  the  item  i3. 
field  appears. 


The 
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Figure  5-163  RMVAPR  Test  Verification 


Use  INQAPR  to  verify  that  the  appears  if  criterion  for  i3  was 
removed.  The  message  "Value  clause  not  found”  is  displayed. 
Press  <QUIT>  to  return  to  the  IISS  Function  Screen  and  then 
press  <QUIT>  again  to  complete  this  Unit  Test. 
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APPENDIX  A 
FP  TEST  FORMS 

/*  these  forms  are  for  testing  form  processor  */ 

CREATE  FORM  ARTESTP 

prompt  center  at  1  40  "ARTEST  Parameters" 

item  parml 
at  3  10 
size  10 

display  as  input 
prompt  at  left  "parml" 

item  parm2 
at  5  10 
size  10 

display  as  input 
prompt  at  left  "parm2" 

item  parm3 
at  7  10 
size  10 

display  as  input 
prompt  at  left  "parm3" 

item  parm4 
at  9  10 
size  10 

display  as  input 
prompt  at  left  "parm4" 

CREATE  FORM  ffl 

ATTRIBUTE  blackfg  (background  white,  display  black) 

ATTRIBUTE  redfg  (background  white,  display  red) 

ATTRIBUTE  greenfg  (background  black,  display  green) 

ATTRIBUTE  yellowfg  (background  black,  display  yellow) 

ATTRIBUTE  bluefg  (background  white,  display  blue) 

ATTRIBUTE  magentafg  (background  white,  display  magenta) 
ATTRIBUTE  cyanfg  (background  black,  display  cyan) 

ATTRIBUTE  whitefg  (background  black,  display  white) 

BACKGROUND  blue 
PROMPT  AT  1  2  "Command  Line" 

PROMPT  AT  21  2  "Line  21" 

PROMPT  AT  22  2  "Line  22" 
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PROMPT 

AT 

23 
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"Line 

23" 

PROMPT 

AT 

24 

2 

"Line 

24" 

PROMPT 

AT 

25 

2 
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PROMPT 
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item  iO 
at  1  70 
size  8 

display  as  text 
value  "form  ffl" 

item  i3 
at  21  11 
size  8 

display  as  text 
value  "Display:" 

item  i4 
at  1  20 
size  40  by  2 
display  as  input 
help  pathcom 

WINDOW  Wl  (2  V  1) 

AT  3  2 

SIZE  10  BY  4 
background  white 
appears  if  'ffl. ff6.il' 

WINDOW  W2(2  V  1,  2  H  1) 
AT  3  15 
SIZE  10  BY  4 
background  xparnt 

WINDOW  wnf 
at  3  45 
size  *  by  * 
background  green 

WINDOW  w3 
at  3  60 
size  10  by  8 
background  yellow 

form  ff2  (2  h  4) 
at  12  1 
size  12  by  4 

form  ff3 
at  12  32 
size  10  by  4 


<  "11111" 
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form  ff4  (2  V  1) 
at  16  2 
size  10  by  2 

form  ff5 
at  12  43 
size  10  by  4 

form  ff6 
at  12  55 
size  10  by  4 

form  ff7 
at  12  68 
size  10  by  4 

form  ff8 
at  16  13 
size  10  by  4 

item  fgn 
at  21  20 
size  60  by  3 
display  as  output 

CREATE  FORM  ff2 
prompt  at  1  2  "form  ff2" 

item  il(2  h  1) 
at  2  2 
size  2 

display  as  input 

item  i2 
at  3  2 
si.z6  3 

domain  (NUMERIC  MAXIMUM  6 
display  as  input 

create  form  ff3 
prompt  at  1  2  "form  ff3" 

item  il(2  v  1,  2  h  1) 
at  2  2 
size  3 

display  as  input 


MINIMUM  1) 
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create  form  ff4 
background  black 
prompt  at  1  2  "form  ff4'' 

item  il 
at  2  2 
size  4 

display  as  input 

help  "This  is  a  help  string" 

create  form  ffS 
background  white 
prompt  at  1  2  "form  ffS" 

item  il 
at  3  3 
size  1  by  2 
display  as  in^ut 
help  application 

create  form  ff6 
background  xparnt 
prompt  at  1  2  "form  ff6" 

item  il 
at  3  6 
size  1  by  4 
display  as  input 

create  form  ff7 
prompt  at  1  2  "form  ff7” 

item  il(3/6  v  0,  2/4  h  1) 
at  2  2 
size  1 

display  as  input 

create  form  ffS 
prompt  at  1  2  "form  ffS" 

item  il 
at  3  2 
size  8 

display  as  input 
create  form  ff9 
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prompt  at  1  2  "form  ff9" 

item  il 
at  2  2 
size  8 

display  as  input 

window  w4 
at  3  1 

size  10  by  5 
display  as  black 

create  form  fflO 
size  10  by  8 

prompt  at  1  2  "Form  fflO" 

item  il  (*  v) 
at  2  2 
size  4 

display  as  input 

create  form  ffll 
size  10  by  8 

prompt  at  1  2  "Form  ffll” 

item  il  (4/  *  v) 
at  2  2 
size  4 

display  as  input 

create  form  pathcom 

item  i4 
at  3  47 
size  1 

display  as  input 
help  morhelp 

prompt  at  1  30  "Commands  for  ARTEST” 
prompt  at  3  30  "  More  Commands;" 
prompt  at  5  10 


prompt  at  6  9  "add  form  to  a  window 
form" 

prompt  at  7  9  "delete  pages  from  window 
page" 
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_ _ _ _ 

addfrm  window 
rmvpag  window 
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prompt  at  8  9  "replace  page  in  window 
form" 

prompt  at  9  9  "close  form 

prompt  at  10  9  "put  data  to  form  item  array 
prompt  at  11  9  "get  data  from  form  item  array 
inst ( 0=prev, l=cur)  path" 

prompt  at  12  9  "change  attributes:  background 
dur(prm=0, tmp=l)  attrib" 

prompt  at  13  9  "get  attributes:  background 
dur ( prm=0 , tmp=l ) " 

prompt  at  14  9  "put  and  get  temp  attributes (b) 
attrib" 

prompt  at  15  9  "get  name  of  form  on  page  n 
page" 

prompt  at  16  9  "get  number  of  pages  in  window 

prompt  at  17  9  "put  cursor  to  field 
prompt  at  18  9  "window  set (term  within  term) 

prompt  at  19  9  "change  attributes:  foreground 
dur (prm=0, tmp-1)  attrib" 

prompt  at  20  9  "get  attributes:  foreground 
dur ( prm=0 , tmp=l ) " 

prompt  at  21  9  "put  and  get  temp  attributes (f) 
attrib" 


rplfrm  window  page 

clsfrm  form" 

pdata  path  data" 
gdata 

putbak  path 
getbak  path 
tmpbak  path  dur 

gpage  window 

gwindo  window" 

putcur  path" 
oiscr  path" 

putatt  path 

getatt  path 

tmpatt  path  dur 


create  form  morhelp 


item  i4 
at  3  47 
size  1 

display  as  input 
help  arthlp2 

prompt  at  left  "More  More  Commands" 
prompt  at  2  28  "More  Commands  for  ARTEST" 
prompt  at  4  10 


prompt  at  5  9  "open  logical  device  opnldv  returns 

Idvid" 

prompt  at  6  9  "close  logical  device  clsldv 

Idvid (except  'HOME')" 
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prompt  at  7  9  "set  logical  device 
col  wj ith  depth” 

prompt  at  8  9  "change  logical  device 
ldvid(default  is  'HOME')" 
prompt  at  9  9  "inquire  logical  device 
Idvid" 

prompt  at  10  9  "put  data  to  Virtual  Terminal 
prompt  at  11  9  "get  data  from  Virtual  Terminal 
prompt  at  12  9  "parse  fully  qualified  name 
lev(0=lst, l=fst,-l=nxt21st,etc) ” 
prompt  at  13  50  "use  pfl6(0)  first” 
prompt  at  14  9  "get  default  qualified  name 

prompt  at  15  9  "set  default  qualified  name 

prompt  at  16  9  "put  message  line  string 

prompt  at  17  9  "put  message  line  code 

prompt  at  18  9  "output  a  screen 
prompt  at  19  9  "put  cursor  at  a  location 
column" 

prompt  at  20  9  "get  the  length  of  a  buffer 
create  form  arthlp2 

prompt  at  2  28  "More  Commands  for  ARTEST” 
prompt  at  3  10 

II _ _ _ 11 

prompt  at  5  9  "add  an  element  to  an  array  addelm  path” 
prompt  at  6  9  "open  a  foirm  opnfrm  form” 

prompt  at  8  10 

II _ _ _ _ _ _ _ _ _ __._ii 

prompt  at  9  23  "Special  Function  Key  Definitions" 
prompt  at  10  10 

II _ _ _ _ _ _ _ _ _ _ _ 

prompt  at  11  20  "use  pfl6(0)  to  display  path  name  of  cursor 
position" 

prompt  at  12  20  "use  pfl5(3)  to  send  screen  to  printer  (to  call 
'prntvt ' ) " 

prompt  at  13  20  "use  pfl7(.)  to  refresh  the  screen  (to  call 
'rfshvt ' ) " 

create  form  ffl2 
item  il 

display  as  input 
at  1  2 
size  8  by  5 

create  form  ffl3 
item  il 


putvti  data" 
getvti  " 
parfqn 


getdqn" 
setdqn  path" 
pmsgls  string" 
pmsglc  code" 
outscr  path" 
putloc  path  row 

gdatln  path" 


setldv  Idvid  row 
chgldv 

inqldv  returns 
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display  as  input 
at  1  2 

size  6  by  34 

create  foim  ffl4 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 
value  "xxx" 
size  3 

create  form  ffl5 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 
appears  if  2  >  1 
value  "xxx" 
size  3 

create  form  ffl6 
item  il 

display  as  input 
at  1  2 
size  3 
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item  12 

display  as  output 
at  2  2 
value  'll' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 
appears  if  2  <  1 
value  "xxx" 
size  3 

create  form  ffl7 
item  il 

display  as  input 
at  1  2 
size  3 

item  12 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 
appears  if  'il'  !=  1 
value  "xxx" 
size  3 

create  form  ffl8 
item  il 

display  as  input 
at  1  2 
size  3 

item  12 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  13 

display  as  output 
at  3  right  of  il 
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appears  if  between (' il ' ,  1,  10) 
value  "xxx” 
size  3 

create  form  ffl9 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 

appears  if  in('il',  0,  1,  2,  2,  4,  5,  6,  7,  8,  9,  10) 
value  "XXX" 
size  3 

create  form  ff20 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 

at  3  right  of  il 

appears  if  ' il '  >  10  ?  1  :  0 

value  "xxx" 

size  3 

create  form  ff21 
item  il 

display  as  input 
at  1  2 
size  3 
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item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 

at  3  right  of  il 

appears  if  'il*  >  “CCC"  ?  1  :  0 

value  "xxx" 

size  3 

create  form  ff22 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 
appears  if  NOT  * il ' 
value  "xxx" 
size  3 

create  form  ff23 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 
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at  3  right  of  il 

appears  if  IN (BETWEEN ( 'il' ,  1,  10),  1,  2,  3,  4) 
value  "XXX" 
size  3 

create  form  ff24 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 

appears  if  IN (BETWEEN (' il' ,  "AAA",  "CCC") ,  1,  2,  3,  4) 
value  "xxx" 
size  3 

create  form  ff25 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 

appears  if  IN (BETWEEN ( 'il' ,  "AAA",  "CCC"),  "AAA",  "BBB",  "CCC", 

"ODD") 

value  "xxx" 

size  3 

create  form  ff26 
item  il 

display  as  input 
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at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il* 
size  3 

item  i3 

display  as  output 

at  3  right  of  ll 

appears  if  NOT  APPEARS ( • il • ) 

value  "xxx" 

size  3 

create  form  ff27 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 
appears  if  APPEARS ('il') 
value  "xxx" 
size  3 

create  form  ff28 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 
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item  i3  / 

display  as  output  / 

at  3  right  of  il  / 

appears  if  APPEARS (' ff24 . il' )  / 

value  "xxx"  / 

size  3  / 

create  form  ff29  / 

item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 

appears  if  'il'  >*  1  ?  'il'  =  5  ?  1  ;  0  :  1 
value  "xxx" 
size  3 

create  form  ff30 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 

appears  if  NOT  IN('il'  >=1?  'il'  =5?1  ;  0  :  1,  1,  2,  3) 
value  "xxx" 
size  3 

create  form  ff31 
item  il 


A-15 


UTP620344200 
30  September  1990 


display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 

appears  if  'il'  <=  0  OR  'il'  >=  10 
value  "xxx" 
size  3 

create  form  ff32 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 

appears  if  'il'  !=  11  AND  'il'  >=  10 
value  "xxx" 
size  3 

create  form  ff33 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 
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item  i3 

display  as  output 

at  3  right  of  il 

appears  if  GWINDO('.w3')  > 

value  "xxx" 

size  3 

create  form  ff34 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  *il' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 
appears  if  CURSOR('i2') 
value  "xxx" 
size  3 

create  form  ff35 
item  il 

display  as  i  \put 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 
appears  if  gpage('.w3',  1 
value  "xxx" 
size  3 

create  form  ff36 


)  =  "FF3" 
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item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 
at  3  right  of  il 
appears  if  getatt('il',  0) 
value  "xxx" 
size  3 

create  form  ff37 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  'il' 
size  3 

item  i3 

display  as  output 

at  3  right  of  li 

appears  if  not  getatt ( ' il ' , 

value  "xxx" 

size  3 

create  form  ff38 
prompt  at  1  4  "ff38" 

item  il 

display  as  input 
at  2  2 
size  3 

item  i2 

display  as  output 


=  "INPUT" 


0)  !=  "INPUT" 
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at  2  6 
value  'il' 
size  3 

form  fl 
at  4  2 

appears  if  'il'  >  10  ?  1  :  0 
size  7  by  6 

create  form  fl 
prompt  at  1  2  "Fl" 

create  form  ff39 
item  il 

display  as  input 
at  1  2 
size  3 

item  i2 

display  as  output 
at  2  2 
value  ' il ' 
size  3 

item  i3 

display  as  output 

at  3  right  of  il 

appears  if  not  role ("manager") 

value  "XXX" 

size  3 
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APPENDIX  B 
VTIOO  KEYPAD  LAYOUTS 


Figure  B-1  Window  Manager  Mode 


Figure  B-2  Scroll/Page  Mode 
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Figure  B-3  Status  Mode 
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Figure  B-4  Text  Editor  Mode 
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